home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / bootpicturetools / amigastart / amigastart.guide (.txt) next >
Amigaguide Document  |  1996-04-07  |  12KB  |  230 lines
  1. @Database AmigaStart.doc
  2. @Node main "AmigaStart documentation"
  3.  *********************
  4.  *  AmigaStart 95.8  *                              
  5. 1995 Ian J. Einman
  6.  *********************
  7.  This program gives your computer a startup screen containing system
  8.  information and a logo, sort of like many workstations.  I spent a
  9.  little time drawing some artwork, and I hope you like this one better
  10.  than similar programs. It is more customizable and has been fine-tuned
  11.  by the suggestions and contributions of many other people.
  12.     Contents
  13. -----------------------------------------------------------------------------
  14.   @{" Features     " link Fea }    1001 excellent features (base two).
  15.   @{" Installation " link Ins }    Fill your hard drive with more junk.
  16.   @{" Options      " link Opt }    Master the magic, learn the spells.
  17.   @{" History      " link Hist}    How has it evolved, from ape to man?
  18.   @{" Artwork      " link Art }    Who made the artwork, and can I draw?
  19.   @{" Author       " link Auth}    Who hath wrought this... Evil upon us?
  20. @endnode
  21. @node Fea "Features"
  22.     AmigaStart Features
  23. -----------------------------------------------------------------------------
  24.   Displays Processor & Math coprocessor; Free Fast & Chip Memory;
  25.     Kickstart & Workbench version; Graphics chips
  26.   Fades in and out, smooth fade with AGA
  27.   Blanks mouse pointer; Forces other screens to open behind it
  28.   Included Rainbow Logo modeled after Commodore WB 2.1/3.0 logos;
  29.     Easily customizable logos, use included logo as template
  30.   Use any number of colors, any fonts and font sizes
  31.   Use any monitor or display mode
  32.   Built-in support for PAL, NTSC, DBLPAL, DBLNTSC, and VGA monitors
  33.   Customizable text strings, decimals, separators;
  34.     AmigaStart can use whatever language or customs you want it to
  35.   Quits with CTRL-C, CTRL-E, or a keypress
  36.   Small, efficient, and highly customizable
  37. @endnode
  38. @node Ins "Installation"
  39.     How to Install AmigaStart
  40. -----------------------------------------------------------------------------
  41. 1.  Makedir S:Plus
  42. 2.  Copy s/plus/AmigaStart s/plus/#?.as TO S:Plus
  43. 3.  Add the following line to your startup-sequence:
  44.  Run >NIL: S:Plus/AmigaStart
  45.     It is best to put it after IPrefs is running, so the screen does not
  46.     move when your overscan preferences are loaded.
  47. 4.  You should have Times/18 and Times/24 in your fonts directory.  These
  48.     are system standard fonts, so if they are not included with this archive,
  49.     you may copy them from your Workbench disks. You may choose other fonts,
  50.     but if they are not specified and available, AmigaStart will look for
  51.     Times, and then will fail if Times cannot be found.
  52. 5.  Install the systemplus.library if it is newer than the one you already
  53.     have.  Check this by typing "version systemplus.library".  The version
  54.     included here is 95.5.
  55. 6.  Now you need to set it up so it will go away once Workbench is
  56.     loaded.  There are several ways to do this.
  57.     If you have AutoStart (
  58. 1995 Ian J. Einman), add the following as a DOS
  59.     command:  "S:Plus/AmigaStart CLOSE".  Put it at the bottom, if you wish,
  60.     so it makes the screen disappear after everything is loaded.
  61.     You may add the command S:Plus/AmigaStart CLOSE after the LoadWB command
  62.     in your startup-sequence.  You may wish to put a Wait command before it
  63.     to make it disappear at the right time.
  64. @endnode
  65. @node Opt "Options"
  66.     Command Line Options
  67. -----------------------------------------------------------------------------
  68. LOGO:
  69. You may use one of the included logos, or make your own.  The default logo is
  70. "Default_16.as", which is loaded if no other name is specified.  Logos are
  71. searched for in the S:Plus directory with a file extension of ".as".
  72. Example:  AmigaStart BlueMarble_16.as
  73. If you don't like my artwork (it only took a half hour, I won't cry if you
  74. think it sucks) you may replace it.  Load it into a paint program.  Be
  75. careful to use a similar palette.  If you don't, things will look strange.
  76. It isn't necessary to get the size or colors the same, feel free to
  77. experiment.
  78. Maximum logo size:  330 x 390   Resolution:  640 x 400 or greater
  79. Maximum info size:  290 x 390   Max Colors:  16 ECS/256 AGA (no HAM or EHB)
  80. -----------------------------------------------------------------------------
  81. SWAP/S:
  82. By default the logo is on the left side, and the information is on the right
  83. side.  You may swap the two, if you prefer.
  84. -----------------------------------------------------------------------------
  85. PAL/S,NTSC/S,DBLPAL/S,DBLNTSC/S,VGA/S:
  86. AmigaStart may use any of the following monitors:  PAL, NTSC, DBLPAL,
  87. DBLNTSC, and VGA.  Simply add the monitor name after the command.
  88. Example:  S:Plus/AmigaStart DBLPAL
  89. You cannot use monitors that have not been added to the system.  AmigaStart
  90. can only open screens in the default mode of your system unless the monitor
  91. drivers have been loaded.
  92. -----------------------------------------------------------------------------
  93. MODE/K:
  94. You may specify any monitor display ID in hexadecimal.  This may be used with
  95. other monitors that are included with the OS, such as Euro36, 72, and Super72,
  96. or a third party monitor, like those supplied with graphics board emulations.
  97. Example:  AmigaStart MODE=$19004
  98. The screen would open in "NTSC:Hi-Res/Interlaced".  Be careful with this option,
  99. the monitor must support a 640*400 resolution or greater, and support the number
  100. of colors in the image file you are loading.
  101. You must specify the display mode as well.  The built-in monitors select the
  102. proper mode for you, but you may override it with this option.
  103. The Mode ID must be in hexadecimal, and may be prefaced with a "$" or "0x".
  104. Consult your graphics board documentation for the monitor mode ID specification,
  105. or open ScreenMode Preferences and record the information from there.
  106. ------------------------------------------------------------------------------
  107. TITLEFONT/K,TITLESIZE/K/N,TEXTFONT/K,TEXTSIZE/K/N:
  108. By default, the title font is Times 18, and the text font is Times 24.
  109. You may change this if you like.
  110. Example:  AmigaStart TITLEFONT=ShannonBook.font TEXTFONT=Helvetica.font
  111. It is recommended you use the same size of font, but it the font you wish
  112. to use is a slightly different size, you may also change the size.
  113. Example:  AmigaStart TEXTFONT=Platinum.font TEXTSIZE=23
  114. It is useless to specify the font size if you do not specify the name.  If
  115. you want to use Times 16, you must do the following:
  116. Example:  AmigaStart TITLEFONT=Times.font TITLESIZE=16
  117. -----------------------------------------------------------------------------
  118. TEXT_SYSTEM/K,TEXT_KICKSTART/K,TEXT_WORKBENCH/K,TEXT_GRAPHICS/K,
  119. TEXT_PROCESSOR/K,TEXT_CPU/K,TEXT_FPU/K,
  120. TEXT_MEMORY/K,TEXT_CHIP/K,TEXT_FAST/K:
  121. These options allow to replace the built-in text strings with their own
  122. strings (in their own language, presumably).  You may also just want to
  123. name something differently than I did, or use lowercase, or whatever.
  124. Example:  AmigaStart TEXT_SYSTEM="LA SISTEMA" TEXT_MEMORY="LA MEMORIA LIBRE"
  125. This is a crude form of language support, but since there are only a few
  126. strings it works fine, and some of the strings you probably won't translate
  127. anyway (like Kickstart and Workbench).
  128. -----------------------------------------------------------------------------
  129. SEPARATOR/K,DECIMAL/K:
  130. These options allow you to use the characters you customarily use in your
  131. country for decimals (version numbers) and thousand place separators. I
  132. realize that the United States is basically backwards from most countries
  133. on earth, and so now I have made it possible for you to overlook the
  134. nationality of the author.
  135. Example:  AmigaStart SEPARATOR="."
  136. --->  Chip RAM:  1.564 K
  137.       Fast RAM:  2.895 K
  138. Example:  AmigaStart DECIMAL=","
  139. --->  Kickstart:  39,46
  140.       Workbench:  40,38
  141. Warning: if SEPARATOR does not seem to work, check your spelling.  It is
  142. one of the most commonnly mispelled words in the English language. Two A's,
  143. and one E!
  144. -----------------------------------------------------------------------------
  145. CLOSE/S:
  146. This switch is NOT needed to close the screen; if the screen is already
  147. open, and you type AmigaStart again, the screen will close.  However, if
  148. the screen did not open (due to error, or if it wasn't loaded due to
  149. multiple startups), typing AmigaStart would make it open!  So if you use
  150. "AmigaStart CLOSE" it will close if it is open, and do nothing if the screen
  151. is not open.
  152. If you click in the middle of one of the windows and hit a key, the screen
  153. will go away.  This is useful if your system goes astray.  If a window opens
  154. on the AmigaStart screen, that is all right, the screen will close when all
  155. the windows are off of it.
  156. @endnode
  157. @node Art "Copyrights"
  158.     Copyrights, Artwork & Distribution
  159. -----------------------------------------------------------------------------
  160. AmigaStart         
  161. 1995    Ian J. Einman
  162. Helvetica.font     
  163. 1990    Commodore-Amiga
  164. Times.font         
  165. 1990    Commodore-Amiga
  166. systemplus.library 
  167. 1994-95 Ian J. Einman
  168. Rainbow Logo       
  169. 1992    Commodore-Amiga
  170. Default_#?.as         by    Ian J. Einman
  171. BlueMarble_16.as      by    Ian J. Einman
  172. Future_64.as          by    Ian J. Einman
  173. CreativeMinds_#?.as   by    Ron Glidden
  174. The AmigaStart program/package is freeware. Distribute it as much as you
  175. like, but please keep it all together.
  176. >>You may do what you want with this; use it, include it with your
  177. >>archive, upload it seperately, laugh and then delete it, whatever..
  178. >>I just wanted to share it with you.
  179. >>Thanks for sharing your work with us!
  180. >>Ron Glidden
  181. >>GEnie: R.GLIDDEN
  182. >>r.glidden@genie.geis.com
  183. @endnode
  184. @node Hist "History"
  185.        AmigaStart History
  186. -----------------------------------------------------------------------------
  187. 95.8   Added MODE for support of graphics cards and other monitors.
  188.        Increased vertical display height to 390, to accomodate Future_64.as.
  189. 95.6   Added ability to customize fonts, text, and comma/decimal characters.
  190.        AGA support, and new patterns for windows.  Logo/info may be traded.
  191.        Mouse blanking.
  192. 95.5a  Added 68060 support (well, if they set the bit I think they are
  193.        going to). It should work with the CyberStorm 060, but I would
  194.        appreciate it if you would give me one to test it with.
  195.        Fixed a problem with some accelerator boards setting AFB_FPU40 when
  196.        AFB_68040 is clear.  This is sort of a dorky thing to do anyway, how
  197.        could I have known this would happen. I guess it was before the 68040
  198.        was supported.
  199. 95.5   First version (whee.)
  200.        Thanks to:
  201. -----------------------------------------------------------------------------
  202.   Richard Thoreson, for letting me develop it on his 1200
  203.   Ron Glidden, for contributing art and putting the doc into guide format
  204.   Trevor Dayley (tldaley@world.net), for Australian distribution
  205.   Siewert Westerneng (swestern@dds.nl), for European distribution
  206.   Gandalf @ Blackbox, for his comments and begging for 256 color support
  207.   Other people, who reported small insects in the program
  208. @endnode
  209. @node Auth "Author"
  210.    Author Information
  211. -----------------------------------------------------------------------------
  212.    Ian J. Einman                        i.einman@genie.geis.com
  213.    P.O. Box 5711                        74271.2766@compuserve.com
  214.    Bellingham, WA 98227
  215. Tell me if you like the program. I'd appreciate your comments. Don't send
  216. money, if you are rich, register one of my other programs, like AddPower
  217. or AutoStart.
  218. Report any and all bugs.  This is an order.  I have found that some
  219. accelerator boards set bits differently than I would expect.  If you have
  220. a 68020 and my program says you have a 68060, it is a bug in my logic.
  221. This program can not actually give you a better processor, or a better
  222. spouse, or a better job.
  223. Also, if you draw a logo for it you just think is wonderful, and would like
  224. to see it included in the archive, send it to me.  I will laugh at it, and
  225. make fun of you.  I may also include it in the archive, so others may do
  226. the same.
  227. P.S. - If you have a few beers, my logo looks rad.  Please try this before
  228.        you delete it.
  229. @endnode
  230.